home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / f2mqbbs.zip / F2MDOC-Q.DOC < prev    next >
Text File  |  1990-04-01  |  8KB  |  219 lines
  1.  
  2. File-2-Message Version 0.20 
  3. Copyright 1990 by Scott Gordley 
  4. All Rights Reserved 
  5. Quickbbs, RemoteAccess Version
  6. Quickbbs (C) The Quickbbs Group
  7. RemoteAccess (C) Continental Software
  8.  
  9.  
  10. Licensing Information 
  11. --------------------- 
  12.  
  13.  
  14. This program is my property.  It is to be distributed in unmodified
  15. form.  You are free to use it in it's unmodified form.  If you like
  16. the program and use it, I will be glad to accept donations, but it
  17. is not required.  I would like to receive a netmail message from
  18. you letting me know that you are using the software.  It would be
  19. nice to know if it is being put to any use.  If you like the
  20. program, but need some sort of modification. I will try to make
  21. the modifications as time permits.  I am developing a full screen
  22. version and if you are interested in doing alpha and beta testing
  23. for me, let me know when you netmail me.  I am also working no
  24. a version that will be a robot mailer also.  I do not run a BBS, so
  25. I need people to test these programs under normal usage, and to
  26. make suggestions for enhancements.
  27.  
  28. For commercial use, reasonable licensing terms are available.
  29.  
  30. Scott Gordley 
  31. 2811 Fowler Avenue 
  32. Raleigh, N.C. 27607 
  33. 1:151/122.1 
  34.  
  35.  
  36.  
  37. What Does It do? 
  38. ---------------- 
  39.  
  40. The program turns a text file into a message that can be tossed
  41. with a mail tossing program.  You may process a message to your
  42. users in three ways. 
  43.  
  44. 1) Enter the users name in the " To " field.  Single message to  
  45.    that user.  Default Private message
  46. 2) Read Users.bbs (Quickbbs, RemoteAccess format); 
  47.    Default Private message. 
  48.    Default Security level is 10-32000. This means every user from
  49.    security level 10 to the maximum will receive a message.  If  
  50.    you specify a security level you MUST SPECIFY the lower AND the
  51.    upper value. 
  52. 3) Read a text file.  The file must end in the extension TXT. 
  53.    Default Public message. 
  54.  
  55. ******************************************************************
  56. ** The program will take care of missing parameters for message **
  57. ** status and for security level, with the exception in 2       **
  58. ** above, BUT it means that the program has to evaluate extra   **
  59. ** code to enumerate possibilities.  I suggest that you put in  **
  60. ** all of the parameters.  It is designed to be forgiving of    **
  61. ** mistakes not to take care of all possible input errors.      ** 
  62. ****************************************************************** 
  63.  
  64.  
  65. Getting Started 
  66. --------------- 
  67.  
  68. 1st 
  69. --- 
  70.  
  71. No Warranty or guarantee of any kind with this program. Use this
  72. completely at your own risk.  It would be a good idea to backup
  73. messages before you run this the first time.  It was designed for
  74. Quickbbs, but should work with other formats that use FidoNet<tm>
  75. Standards (FTS-0001) for netmail. There is no promise that it will
  76. though. 
  77.  
  78. 2cnd 
  79. ---- 
  80.  
  81. Run F2MCFG-Q to create the configuration file that the program
  82. needs.  The program writes some stuff in Hex that it needs, then
  83. the path your net mail directory, lastly your origin.  Of course
  84. you may change any of these with your text editor, as long as you
  85. know what you are doing.  I suggest using the configuration file.
  86. It puts the configuration file in the correct format. To change
  87. something just rerun the setup program. 
  88.  
  89. My Configuration File looks like this 
  90.  
  91. Scott Gordley 
  92. $57$76$01$00 
  93. d:\fd\mail 
  94. Anova Point BBS, Raleigh, N.C. (1:151/122.1) 
  95.  
  96. First. The default name to use with a '*' on the command line. 
  97.  
  98. Note : The Hex numbers are my address as listed in my mail tosser
  99.        configuration file.  I am a point, the address that I am  
  100.        using for my mail tosser is 30295/1;
  101.  
  102.        30295  $7657 
  103.        1      $0001 
  104.        IF your address is 151/122.0 then 
  105.        151    $0097 
  106.        122    $007A 
  107.  
  108. Next.  Path to netmail directory. There is no trailing backslash.
  109.        If you use the configuration program it will remove it even
  110.        if you try to put one in. 
  111.  
  112. Last.  Your origin line.  You are responsible for Capitalization,
  113.        punctuation, and line length in the origin line. 
  114.  
  115.        Just run the setup program! 
  116.  
  117. 3rd 
  118. --- 
  119.  
  120. Look at the provided Batchfile. 
  121.  
  122.  
  123. FORMAT 
  124.  
  125. PROGRAM  From      TO       SUBJECT  AREA   FILE     Status  SEC
  126. F2M-QBBS Joe_Sysop John_Doe Report  SYSOP D:\TXT\DL.ASC  1 10-32000
  127. Alternate  *                                             0       
  128.  
  129.     "From" 
  130.        Field 36 characters 
  131.        Your name or Sysop or * Star symbol means 
  132.        use the name in the configuration file. 
  133.     "To" 
  134.        Field 36 characters 
  135.        Note : "To" field also be "ALL" or Joe_Steven_Sysop just 
  136.        remember the underscores. The "Subject" field is similiar. 
  137.     "Subject" 
  138.        Field 72 characters 
  139.     "Area" 
  140.        Field same as your mailtosser 
  141.     "File" 
  142.        Field you tell me (should to plenty) 
  143.     "Status" 
  144.        1= Private 0 = Public (Default Private) 
  145.     "SEC" 
  146.        Security level of user in users.bbs to receive the message. 
  147.        This only has an effect when reading users.bbs.  Quickbbs 
  148.        format. 
  149.        Maximum line length is something like 135 characters so   
  150.     count! 
  151.      Empty spaces are not significant 
  152.  
  153. The program takes care of most of the capitalization for you. 
  154. Although it doesn't hurt to use correct capitalization.  ALSO, the
  155. program is limited to 200 lines of text for the input message. 
  156. This is just because I could not imagine sending more.  If you need
  157. to send a larger message, let me know.
  158.  
  159. ****************************************************************** 
  160. You may mail to people listed in a plain ascii text file. You
  161. must provide the path to the file (d:\qbbs\names.TXT), the
  162. extension must be .TXT for the program to work.  Also if you
  163. are using Quickbbs you can specify Users.bbs on the command line,
  164. in place of the "To" field and then add an additional parameter
  165. for the low minimum and maximum security level to receive the
  166. message, this is in the form of 10-32000.  The default status
  167. is public(1) and the default security level is 10-32000.  If
  168. you change from the default security level you  must enter both
  169. values say like 100-32000, NOT just 100!!!  This is useful if
  170. you want to only send a message to a specific group of users.
  171. The maximum length of the message at present it 200 hundred
  172. lines, which I would think would be plenty, and is 79 columns
  173. wide.  This can be easily changed if need be.
  174. ***************************************************************** 
  175.  
  176. 4th 
  177. --- 
  178.  
  179. Place the program "F2M-QBBS.EXE" AND the configuration file
  180. "F2MCFG-Q.CFG" either in your PATH or in the calling directory. 
  181. I suggest that they go in a directory in your PATH.  The executable
  182. file searches the dos path for the configuration file. 
  183.  
  184. 5th 
  185. --- 
  186.  
  187. You can delete the setup program after you have completed the cfg
  188. file.  Please don't modify the configuration file unless you are
  189. sure that you know what you are doing, at least the Net/node number
  190. stuff. 
  191.  
  192. File list 
  193.  
  194. F2M      BAT      382   2-09-90   5:00p Sample Batch file
  195. F2MCFG-Q CFG       81   1-14-90   6:05p Sample configuration file
  196. F2MDOC-Q DOC     8144   2-14-90  11:24a Docs
  197. F2MCFG-Q EXE     6032   2-09-90   4:56p Configuration Program
  198. F2M-QBBS EXE     9664   2-14-90  11:18a Executable (Full version
  199.                                         ie Reads Users.bbs)
  200. ORDER    FRM     1154   1-28-90   2:46p Order Form 
  201.  
  202. History 
  203. -------- 
  204.  
  205. Ver 0.20 
  206. -------- 
  207.  
  208. Added the feature of reading the quickbbs USERS.BBS file to create
  209. a message to users based on their security level. 
  210.  
  211. Ver 0.10 
  212. -------- 
  213.  
  214. Initial program formulation.  Never made an actual release due to
  215. suggested enhancements by Gerald Sergent a very helpful sysop at
  216. Home By The Sea (1:151/122.0). 
  217.  
  218.  
  219.